home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / adopt42.zip / PROGRAM.EXE / ADOPT.DOC < prev    next >
Text File  |  1991-09-29  |  10KB  |  264 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                             Adopt - A - Door
  11.  
  12.                                  v4.1
  13.  
  14.                              July 29, 1991
  15.  
  16.                         PCBoard 14.x and GAP 4.x
  17.                            WILDCAT!, Spitfire
  18.                              QBBS, RBBS, RA
  19.                                   WWIV
  20.  
  21.                                    by
  22.  
  23.                              Dennis Maidon
  24.  
  25.                           The Parole Board BBS
  26.  
  27.        (919) 965-4696 - Node 1 - Dual Standard - 1200 - 19200 Bps
  28.  
  29.          (919) 965-0068 - Node 2 - Intel 24EX - 1200 - 2400 Bps
  30.  
  31.  
  32.  
  33.  
  34.                                 OVERVIEW
  35.                                 ________
  36.  
  37.     Adopt-A-Door runs just before you regular door program and displays
  38.     the name(s) of your users that have donated funds to purchase a door
  39.     program for your BBS.  What better way to solicit funds that to
  40.     advertise the name of a very generous user.
  41.  
  42.                                  FILES
  43.                                ---------
  44.         ADOPT.EXE       <- The EXEcutable file
  45.         ADOPT.CFG       <- Sample of the CFG file for ADOPT
  46.         ADOPT.DOC       <- This file you are reading now.
  47.         DOOR.BAT        <- Sample of Batch file to run ADOPT
  48.         PAROLE.COM      <- I need to advertise just a bit.
  49.         READ.ME         <- Last minute thoughts and ideas
  50.         ADCNF.EXE       <- Create the ADOPT.CNF file
  51.  
  52.         This ZIP file was created using the -AV function of PKZIP.  If
  53.         my AV is missing then this file may not be complete of has been
  54.         tampered with.  Complete and current editions of this program
  55.         are always available for D/L on The Parole Board BBS.  If the AV
  56.         is missing please complain to your sysop to stop the practice of
  57.         removing AV's as this is your assurance from the programmer that
  58.         the file is complete and virus free.
  59.  
  60.  
  61.                               INSTALLATION
  62.                               ____________
  63.  
  64.  
  65.    Installation is fairly easy and straight-forward. The following steps and
  66.    examples should have you up and running in a very short period of time.
  67.    It is assumed that you are familiar with setting up DOORS on your system.
  68.    To this end, only examples of the configuration file and Door batch file
  69.    are described.
  70.  
  71.       1) Create a directory to hold all ADOPT files
  72.  
  73.       2) Unzip ADOPT.ZIP into the the above directory
  74.  
  75.          NOTE: BRUN45.EXE is not included but is required !!!
  76.  
  77.       3) Create a configuration file, with a name of your choice, or
  78.          modify the  ADOPT.CFG file that is enclosed.
  79.          A description follows:
  80.  
  81.  
  82.  
  83.    C:\WILDCAT\CALLINFO.BBS ──┐  <- For Wildcat!
  84.    C:\WC30\USERINFO.DAT      │  <- For Wildcat! 3.0
  85.    C:\PCB\PCBOARD.SYS        │  <- For PCBoard using PCBOARD.SYS only
  86.    C:\PCB\USERS              │  <- For PCBoard using USERS only
  87.    C:\BBS\DOOR.SYS           │  <- For Systems that support DOOR.SYS
  88.    C:\BBS\DORINFOx.DEF       │  <- For QBBS/RBB/RA.  Replace x with Node #.
  89.    C:\BBS\SFDOORS.DAT        │  <- For Spitfire
  90.    C:\BBS\CHAIN.TXT       ───┘  <- For WWIV
  91.    The Parole Board BBS         <- Your BBS Name
  92.    Dennis                       <- SysOp's First Name
  93.    Maidon                       <- SysOp's Last Name
  94.    Jim Smith                    <- Name of the donor(s)
  95.    ESP!                         <- Adopted door's name
  96.    YES                          <- Create .DNR Log
  97.    00000                        <- Registration Number
  98.    C:\WILDCAT\                  <- Path to create the .DNR log
  99.    YES                          <- YES = SUPER Screen   NO = Standard Screen
  100.    NO                           <- Turn off Prompt
  101.  
  102.      Edit this .CFG file to suit your individual BBS.  All 11 lines MUST
  103.      be present.
  104.  
  105.    Line 1:  This line points to where ADOPT.EXE will find the callers
  106.             information file.  Just include the line that your particular
  107.             BBS uses.  DO NOT put all of them in the CFG file.
  108.  
  109.    Line 2:  Place the name of your BBS on this line.
  110.  
  111.    Line 3:  SysOp's first name goes here.
  112.  
  113.    Line 4:  SysOp's last name goes here.
  114.  
  115.    Line 5:  Place the donor(s) name(s) on this line.  If there are more
  116.             than one it will look better to separate them by a "&" as in
  117.             Bob Smith & Johnny House.
  118.  
  119.    Line 6:  Place the name of the adopted door on this line.
  120.  
  121.    Line 7:  YES to create .DNR log or leave blank
  122.  
  123.    Line 8:  Your Registration Number goes here if registered
  124.  
  125.    Line 9:  Path and directory to place .DNR log.  Be sure to add the
  126.             trailing backslash. "\"
  127.  
  128.    Line 10: YES = Super Screen or NO for regular screen.  The SUPER
  129.             screen is configurable.
  130.  
  131.    Line 11: (Y/N) Turn off prompt line if need be
  132.  
  133.         If you use the above CFG file be sure to remove all remarks and use
  134.    a pure ASCII editor such as EDLIN or QEDIT.  Hidden control codes could
  135.    cause the program to depart for worlds unknown.
  136.  
  137.       4) Create a batch file or modify the ADOPT file supplied. A
  138.          description of this file follows:
  139.  
  140.             ECHO off
  141.             CD \DOORS\ESP           Location of ADOPT files
  142.             ADOPT ADOPT.CFG       EXE filename and CFG filename (Name
  143.                                       used in creating file in #3 above)
  144.             ESP! ESP!.CFG          The Adopted Door Program
  145.             CD\WCAT
  146.             CAT.BAT
  147.  
  148.  
  149.        5) When running in more than one node, be sure to supply a
  150.           different configuration name for each node (your choice of name).
  151.           Adopt has been tested under LIVECAT! and performs very well.
  152.  
  153.  
  154.  
  155.  
  156. NOTE: ADOPT supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  157.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  158.       number after the configuration filename. Let's assume your Door is
  159.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  160.       passed to your Door would be:
  161.         FOOBAR FOOBAR.CFG /5
  162.       The /5 tells ADOPT to use IRQ5 rather than the standard IRQ4 that
  163.       is normally used with COM1. No /x parameter is needed for the standard
  164.       IRQ's.
  165.  
  166.  
  167.  
  168.     LIVECAT! USERS
  169.  
  170.     If you are using LIVECAT! to control your doors you will need to
  171. make one small change in your door.bat file.  LC! changes DOOR.SYS to
  172. DOOR.ORG when it shells out to the door.  You will need to add a line in
  173. your script  COPY DOOR.ORG DOOR.SYS.  If you don't do this, ADOPT just
  174. gives up and dies a very unhappy death.  I don't go back and delete it
  175. when ADOPT finishes and I haven't had any problems with it.   If you do,
  176. you might like to delete the DOOR.SYS just as soon as ADOPT finishes
  177. running.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.      The ADCFG.EXE program allows you to set the colors and text that
  185. you like on the Super screen.  The regular screen is already locked into
  186. it's text and colors.  I use this one for doors that have already been
  187. 'adopted' and the Super Screen when I am advertising for a donor.  The
  188. file created is a binary file so do not try to alter or edit it with an
  189. ascii editor.  It just won't work.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                ADOPT-A-DOOR
  196.                                ____________
  197.  
  198.  
  199.     The concept, ADOPT-A-DOOR, allows a caller to register (ADOPT) a door. It
  200.     would be the same as sending in a donation, only this way it is earmarked
  201.     for registering a particular door. In a way, the user feels he/she is
  202.     "getting something in return".
  203.  
  204.  
  205.                               LEGALITIES
  206.                               __________
  207.  
  208.  
  209.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  210.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  211.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  212.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  213.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  214.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  215.       OR BREACH OF ANY WARRANTY.
  216.  
  217.  
  218.  
  219.                              DISTRIBUTION
  220.                              ____________
  221.  
  222.    You may make this file available for downloading from your BBS or you may
  223.    upload it to any BBS of your choice, provided that you do not make any
  224.    changes to the contents of the archive (ZIP file). The archive and its
  225.    individual contents may not be used by any service that charges any money
  226.    whatsoever, without the written permission of the author.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.                              REGISTRATION
  233.                              ____________
  234.  
  235.    I am not a subscriber to the "Crippleware" concept, and this program
  236.    reflects that philosophy. This is a full-featured program, whose
  237.    functionality is not hampered in any way, whether you register it or
  238.    not.  It is only $5 to register this door.  that's not too much to
  239.    ask for a program that could save you big bucks.
  240.  
  241.    Remember, should you have any problems, questions or suggestions, be sure
  242.    to drop me a message on either of the aforementioned BBS or via the
  243.    DOORS or SYSOP conference on PCRELAY/RIME, Node ID = PAROLE.
  244.  
  245.  
  246.                                  THANKS
  247.                              --------------
  248.  
  249.     Special thanks goes out for my wife who is definitely a
  250.     "Computer Widow".
  251.  
  252.     Ted Freeman the author of DOORFRAME, a first class BBS Doors
  253.     Development Library.
  254.  
  255.     My BBS users who have had to endure constant badgering to help me
  256.     test the programs that I have written.
  257.  
  258.     Mark Tetrault and Rick Emmick, SysOps of of two fantastic WILDCAT!
  259.     BBSs, without whom, this program would never have worked.
  260.  
  261.     Mustang! Software -  Home of the best Damn BBS software available
  262.     today.
  263.  
  264.